home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / last50ra.zip / LAST50.DOC next >
Text File  |  1990-12-01  |  5KB  |  131 lines
  1.             
  2.  
  3.  
  4.  
  5.  
  6.                     LAST 50 CALLERS for   
  7.             RemoteAccess Bulletin Board Systems
  8.             
  9.                  Written by Vladimir Heifets, FIDONet 1:163/127.12
  10.  
  11.                Using TurboPascal 5.5 by Borland International Inc.,
  12.           and  RemotaAccess Tools ( RAT ) 0.01 by Continental Software.
  13.  
  14.  
  15.  
  16.                                     DISCLAIMER
  17.  
  18.     This software is  distributed   AS IS   without warranty of ANY kind
  19.      stated or implied.   I can not  be held responsible  for any damage 
  20.     caused by use or misuse of this program. This program is   FREE   of 
  21.         charge ,  no  fee can be charged for distributing of this software.
  22.     If you are using this program and find it useful, then registration
  23.      is required. Just drop me a postcard or send NetMail to 1:163/127.12
  24.      saying that you are using this  program and what you think about it.
  25.  
  26.  
  27.  
  28.                        FILES IN THE ARCHIVE
  29.  
  30.       The original archive contains 2 files:
  31.  
  32.         - LAST50.EXE   -  The executable file itself and
  33.         - LAST50.DOC   -  This file.
  34.  
  35.     The contents of the archive may not be changed or modified in any way.
  36.     No changes may be made to the executable file.   Changes in this file
  37.        may  result  in  crashes  and  data loss  which will be your complete
  38.     responsibility. As Wynn Wagner III put it, " If it breaks, *YOU* have
  39.     the pieces! ".
  40.  
  41.  
  42.                 WHAT IT NEEDS
  43.  
  44.         The program should work on an XT/AT IBM PC compatible machine. You
  45.         should have at least 15 Kbytes free on your Hard  disk so that the
  46.         program  could write the  necessary  files  but I don't think that
  47.         15k of disk space will be such a big problem... ;-)
  48.     The program uses the following RemoteAccess system files:
  49.         
  50.         - CONFIG.RA  
  51.         - LASTCALL.RA
  52.  
  53.     Both files must be present in the directory where you start LAST50.EXE.
  54.     If either file is not  there,   then an error  message  appears on the 
  55.          screen   and   the  program  terminates  without  any  changes.
  56.  
  57.  
  58.                 WHAT IT DOES
  59.  
  60.     At the very first run, the program creates 3 files.
  61.         
  62.         - LAST50.RA  -  Database that contains records of 50 last users
  63.                 of your BBS.   The  information in this file
  64.                 is taken from LASTCALL.BBS file. At the first 
  65.                 run, the program reads  the  last record from
  66.                 LASTCALL.BBS   and writes it  to   LAST50.RA.
  67.                 The rest of the records in   LAST50.RA   are
  68.                 initialized to blanks and will be  replaced
  69.                 by user information everytime LAST50.EXE is
  70.                 run.
  71.  
  72.         - LAST50.ANS -  Two files placed in your TEXTFILE directory.
  73.         - LAST50.ASC     These are  the  actual  files  that will be 
  74.                 displayed on the BBS when  'L)ist Callers  '
  75.                 menu option is chosen.
  76.  
  77.     From  then  on,  the program  will maintain its  files automatically.
  78.         The  program  is aware of   'Exclude sysop from list'   setting in
  79.     RACONFIG. If this is set to  YES,  then Sysop's name  will  NOT   be
  80.         displayed in the listing. The program has NOT been tested with multi-
  81.     node RA system or multitaskers of any kind. So there is no special 
  82.     DesqView aware code present in the program, however there shouldn't 
  83.     be many problems  since it only takes  2  seconds or  less  to  run.
  84.     If you have any problems and you are getting garbage in the LAST50.A??
  85.     files, then delete LAST50.RA file and restart the program again. This
  86.     should fix any problem.   This  isn't likely to happen but just make
  87.            sure  you  know  what  to  do  if  something  goes  wrong.
  88.  
  89.  
  90.                 INSTALLATION
  91.  
  92.     Installation is very easy. Just put the .EXE file into your RA root 
  93.     directory and make sure your  CONFIG.RA  and  LASTCALL.RA  files are 
  94.     present in the  same  directory.    Then change your menus so that 
  95.     'L)ist today's callers'   option would be of type  45    ( Display
  96.     ANS/ASC  file  and  pause   at  the  end )   and  put    "LAST50"
  97.     in the optional data line.   Don't  worry about the  ANS/ASC  files
  98.       themselves, the program creates them at the first run and puts them
  99.         at  the  right place.  After  that,  put   LAST50.EXE  in your RA
  100.     batch file so that it'll run right after  RA  exits after caller or 
  101.     local logon,  and you're all set.   
  102.         
  103.         If you wish, you may tell the program to list less than 50 callers.
  104.     The database is maintained for the last 50 users all the time, but 
  105.     if you specify a command-line parameter like:
  106.  
  107.     LAST50 10 
  108.     
  109.     then your LAST50.ANS/ASC will only contain last 10 users in them. 
  110.         If no parameter is specified the program lists last 30 callers.    
  111.         The number after LAST50 can be any integer from 1 to 50. And you 
  112.     can change it at any time without having to go delete and/or move 
  113.     any files. The program takes care of everything itself. 
  114.                  That's it!       Enjoy...
  115.  
  116.         
  117.         AKNOWLEDGEMENTS
  118.  
  119.     I'd like to thank Bob Adkins of Bob's Place BBS for beta-testing 
  120.     of this program and his invaluable ideas. Thanks a lot, Bob... 
  121.  
  122.  
  123.            Comments and suggestions as well as registration may be sent to :
  124.         
  125.             Vladimir Heifets
  126.             33 Banner Rd. #802
  127.             Nepean, Ontario
  128.             K2H 8Z7 Canada
  129.     
  130.     NetMail at FidoNet 1:163/127.12.
  131.